Format zestaw≤w dla wtyczki k.Style
Zestawy musz╣ spe│niaµ poni┐sze kryteria:
-
Zestawy okre£lane s╣ na dwa sposoby:
-
Zestaw ma sw≤j katalog w folderze konnekt\themes. Nazw╣ zestawu
jest nazwa jego katalogu.
XML opisuj╣cy zestaw musi nazywaµ siΩ theme.xml.
-
XML opisuj╣cy zestaw znajduje siΩ w folderze konnekt\themes, jego
nazw╣ jest nazwa pliku xml'a. Takie zestawy oznaczane s╣ na li£cie samym
"pendzelkiem" i powinny s│u┐yµ tylko zestawom kolorystycznym.
-
Najlepiej gdy ikonki s╣ w formacie ico. Dopuszczalne s╣ r≤wnie┐
bmp,jpg,gif i png, przy czym przezroczysto£µ obs│ugiwana jest tylko w gif i
png... Na systemach nie obs│uguj╣cych 32 bitowych ikonek (starsze od XP)
przy wczytywaniu plik≤w PNG za zupe│nie przezroczyste uznawane s╣ pixele o przezroczysto£ci < 50%.
-
Zmieniane fonty i kolory musz╣ mieµ swoje kontrolki w konfiguracji z
identyfikatorem IMIB_CFG|id (wszystkie ustawienia Konnekta tak w│a£nie maj╣)...
- Wszystkie warto£ci liczbowe mo┐na podawaµ r≤wnie┐ hex'em jako "0xABCDEF" lub "#ABCDEF"
- XML musi byµ absolutnie poprawny!
- W programie, w "Konnekt/DEV/Lista ikon" znajduje siΩ spis wszystkich ikon, kt≤re
mo┐na podmieniµ kStyle'em (lista zale┐y od w│╣czonych wtyczek!) razem z ich identyfikatorami
i numerami list... To Wasze g│≤wne ƒr≤d│o informacji!
Wszystkie pytania prosimy na forum.
Poni┐ej znajduje siΩ schemat pliku theme.xml.
<?xml version="1.0" encoding="Windows-1250"?>
<theme>
Informacje dla wtyczki kStyle
<info>
<name></name>
<author></author>
<url></url>
<comment></comment>
</info>
<icons> Ikonki do za│adowania
Wszystkie warto£ci mo┐na podawaµ hex'em.
Ikony przechowywane s╣ w listach. ListΩ wybieramy podaj╣c parametr
iml. Domy£ln╣ list╣ (i uzywan╣ w 99.9% przypadk≤w) jest "16"
i je┐eli nie jeste£ pewien, czy ikonka jest u┐ywana na pozosta│ych
NIE podawaj parametru iml!
Mo┐na r≤wnie┐ podawaµ iml jako liczbΩ (w nawiasach). Za jednym zamachem mo┐na
w ten spos≤b do│╣czyµ ikonkΩ do kilku list podaj╣c warto£µ OR wszystkich liczb...
Np. podaj╣c iml="#201" dodamy ikonkΩ do 16 i ico2, tylko w ten spos≤b mo┐na
w pe│ni podmieniµ ikony status≤w/wiadomo£ci...
Listy to:
16 (1) - 16x16 u┐ywane w menusach, na li£cie kontakt≤w itd...
32 (2) - 32x32
ico (0x100) - ikonka specjalna (np. ikony okien)
ico2 (0x200) - 2 ikonka specjalna (najczΩ£ciej generowana automatycznie... Ikona status≤w w tray'u...)
bmp (0x1000) - bitmapa (w og≤le nie wykorzystywane...)
Ikonki mozna definiowac na dwa sposoby... Do ikonek, ktorych
ID jest znane uzywamy tego:
<ico file="blah.ico" id=""/>
W pozosta│ych przypadkach definiujemy tak:
Dowolne pole z wyj╣tkiem type mo┐na pomin╣µ.
type - typ ikonki, podajemy (w nawiasie wymagane pozosta│e pola):
"logo" - logo sieci (net)
"overlay" - nak│adka na status (id)
"status" - ikonka statusu (net , id - numer statusu , frame)
"message" - ikonka wiadomo£ci (net , id - typ wiadomo£ci , frame)
net - 0-255 - numer sieci (np. NET_GG to 10)
id - 0-65535 - dodatkowy identyfikator - np. typ wiadomo£ci...
frame - 0-15 - numer wstawianej klatki. Dodaj╣c kolejne, mo┐na robiµ
animowane ikonki (tylko dla zdarze± (nadej£cie wiadomo£ci)) i
dla ikonki statusu ST_CONNECTING
size - rozmiar do wczytania (z ikonek)
bits - minimalna liczba bitow... Warto£µ "tray" wybierze maxymaln╣ dopuszczaln╣ liczbΩ bit≤w w tray'u
XP - 0: Ikonka zostanie za│adowana tylko na systemach nie obs│uguj╣cych cieniowanych ikonek
1: Ikonka zostanie za│adowana tylko na systemach obs│uguj╣cych cieniowane ikonki
gdy nie podamy tego parametru - ikonka zostanie za│adowana niezale┐nie od systemu
Poni┐szy przyk│ad ustawi ikonkΩ status≤w ONLINE i OFFLINE sieci GaduGadu.
Przy okazji jest to zrobione tak, aby wygl╣da│o prawid│owo zar≤wno na XP jak i na innych systemach...
Wczytujemy ONLINE do menus≤w... W online.ico s╣ wersje 32 , 8 i 4 bitowa...
<ico file="online.ico" type="status" net="10" id="0x40" frame="0"/>
Wczytujemy ikonkΩ do tray'a. DziΩki bits="tray" zostanie wczytana odpowiednia wersja ikonki w zale┐no£ci od systemu
<ico iml="ico2" file="online.ico" type="status" net="10" id="0x40" frame="0" bits="tray"/>
Wczytujemy OFFLINE do menus≤w i do tray'a dla system≤w z cieniowanymi ikonkami
<ico XP="1" iml="#201" file="online.png" type="status" net="10" id="0"/>
Wczytujemy OFFLINE do menus≤w dla system≤w bez cieniowanych ikonek
<ico XP="0" file="online.gif" type="status" net="10" id="0"/>
Wczytujemy OFFLINE do tray'a dla system≤w bez cieniowanych ikonek (wczytujemy go osobno, bo na tych systemach w tray'u mog╣ byµ tylko ikonki 16 kolorowe!!!)
<ico XP="0" file="online_16_kolor≤w.gif" type="status" net="10" id="0"/>
</icons>
<colors>
Trzeba znaµ identyfikator kolumny z konfiguracji...
W standardowym Konnekcie nie ma ┐adnej takiej kolumny...
<color id="" value="0xFF0000"/>
</colors>
<fonts>
Trzeba znaµ identyfikator kolumny z konfiguracji...
Poni┐szy przyk│ad zmieni czcionkΩ okna wiadomo£ci...
<font id="156" face="tahoma" size="" flags="bui" charset="" color="0xFF0000" bgColor="0xFFFFFF"/>
</fonts>
</theme>